home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / tick207.arc / TIC2NOTS.DOC < prev    next >
Text File  |  1991-02-08  |  16KB  |  349 lines

  1.  
  2.  
  3.  
  4.                                    Betatic.doc
  5.  
  6.                 Tick 1.31 -
  7.  
  8.                 * Fixed a minor bug that could allow an invalid  AKA  to  be
  9.            used in rare cases.
  10.  
  11.                 * First attempt at instituting the SECONDARY areas.   If you
  12.            ever followed the AREA name in the TIC.CFG file  with  something,
  13.            you  might  have  encountered  the  message about not finding the
  14.            secondary area.   That was a result of code that  was  only  par-
  15.            tially implemented.  Now to explain what a secondary area is, and
  16.            how it works:
  17.  
  18.                 AREA c:\dir\dir2\boo SOFTDIST R13DIST
  19.  
  20.                 The line above is the start of an area block that declares a
  21.            primary  area  tag  of  SOFTDIST,  and  a  secondary  area called
  22.            "R13DIST".  R13DIST MUST be defined as the primary tag of another
  23.            AREA block.
  24.  
  25.                 What will happen  is  this:    If  a  file  is  received  in
  26.            SOFTDIST,  the  file  will  be  echoed  to the nodes listed under
  27.            SOFTDIST (with a file-echo-tag of SOFTDIST),  and  to  the  nodes
  28.            listed  in  R13DIST  (with  a  file-echo-tag of R13DIST).   Files
  29.            received in R13DIST will NOT echo into SOFTDIST,  unless SOFTDIST
  30.            is also a secondary area for R13DIST.
  31.  
  32.                 Files  entering  your  node  will be tossed to the SECONDARY
  33.            area's toss-to directory if a secondary area is defined.  (It can
  34.            be the same as the primary area's directory.)  The  exception  to
  35.            this  is  if STOPDUP is active.   In that event,  if the file has
  36.            been seen in the secondary area but not in the primary  area,  it
  37.            will toss to the primary area.
  38.  
  39.                 If  STOPDUP  is active,  echo will be suppressed in any area
  40.            that has already seen the file.  If the file has been seen in the
  41.            primary, but not the secondary area, only the secondary area will
  42.            receive the outbounds, and vice-versa.  If the file has been seen
  43.            in BOTH areas, the inbound will be failed (renamed to *.BAD).
  44.  
  45.                 The Seenby's for BOTH areas will appear in all the generated
  46.            TICs.   If the same node is listed in both primary and  secondary
  47.            areas, the file will go to that node in the primary area only.
  48.  
  49.                 The  code is not re-entrant.   If the secondary area has its
  50.            own secondary area, a file sent in the primary area will not echo
  51.            all the way down to the 3rd area.  This prevents circular defini-
  52.            tions.
  53.  
  54.                 So what is it good for?  Several things that I can think of,
  55.            and probably a few more I haven't.   In the  SDS,  only  selected
  56.            nodes  are  given  "*"  capability in the national echos.   Using
  57.  
  58.                                                                            1
  59.  
  60.  
  61.  
  62.                                    Betatic.doc
  63.  
  64.            secondary areas,  you could have all nodes in a region link  into
  65.            SOFTDIST  via the local echo R13DIST (or whatever you might chose
  66.            to call it).   The local nodes can all be given "*" capability to
  67.            hatch to each other within R13DIST.  The files will flow locally,
  68.            but  not  enter the national echo unless the RC hatches them into
  69.            that echo.  You might choose to use the secondary area feature to
  70.            merge two echos locally,  while maintaining individual echo feeds
  71.            for  those who want or need the distinction.   To do that,  you'd
  72.            have the same secondary area  for  2  (or  more)  primary  areas.
  73.            Another use may come into play when pre-release is a reality.
  74.  
  75.                 *  Please  note that HATCH now asks for "release in how many
  76.            days?"  That is there for pre-release,  and  is  still  disabled.
  77.            (That  code  is  partially there in HATCH,  but not yet in TICK.)
  78.            You may bypass the prompt by including the command line parameter
  79.            "/R0", to tell HATCH to release it in "0" days, (ie - NOW).
  80.  
  81.                 * Defined a new Files.bbs specification.   %8 will print the
  82.            name  of  the PRIMARY area (that the file was received in) to the
  83.            Files.bbs
  84.  
  85.                 * Fixed the Doc file for the next release,  to  correct  the
  86.            keyword LINEFMT to the proper form, LISTFMT.
  87.  
  88.                 ~~~~~~~~~~~~~~~~~~~~
  89.  
  90.                 Tick 1.32 -
  91.  
  92.                 *  Hopefully  have closed a hole in the COPY routine where a
  93.            file could have been copied to a full disk  and  error  not  have
  94.            been  reported.    I  wonder  if this was the cause for occasions
  95.            where TIC's have been sent without the files?
  96.  
  97.                 * Version 1.31 of HATCH can cause some DUPs if both  primary
  98.            and  secondary areas are active and have a duplicated node listed
  99.            in both.  This version should fix that.
  100.  
  101.                 * Have added support for zones 1 - 32767.   This involved  a
  102.            lot of changes, so look for any flaky operations.
  103.  
  104.                 *  If  you  receive a pre-release file,  the planned release
  105.            date should be logged.
  106.  
  107.                 * Tick now partially implements pre-release!!!    Here's how
  108.            it  works:  Within an AREA block,  those nodes that may receive a
  109.            pre-release file before the release date should have a  "P"  flag
  110.            in  the  flag  field.    When  you  HATCH a file,  the prompt for
  111.            "Release in how many days?" is now active.   If  you  just  press
  112.            <enter>,  the  file is a normal file and is not delayed.   If you
  113.            have a file that you want to send as  a  pre-release,  place  the
  114.            file  into  the  QDIR  directory.     (QDIR  should  NEVER  be  a
  115.  
  116.                                                                            2
  117.  
  118.  
  119.  
  120.                                    Betatic.doc
  121.  
  122.            downloadable directory).   When the prompt for release days comes
  123.            up, answer with the number of days to delay.  (You may bypass the
  124.            prompt  by  using  the /Rx command line option,  where "x" is the
  125.            number of days to delay.   /R2 delays 2 days,  /R0  is  a  normal
  126.            release.
  127.  
  128.                 If  you  have specified a pre-release file,  then only those
  129.            nodes that have a "P" flag will get the file immediately.  Please
  130.            note that only nodes that are also running TICK  1.32  or  higher
  131.            should be given "P" status.   Those nodes will have TIC's and at-
  132.            taches created.   The TIC's will have the seenbys for  all  nodes
  133.            that will eventually receive the file.   In addition,  there will
  134.            be a "*.TOK" file also created in the HOLD directory.   That file
  135.            resembles a TIC closely, but has the seenby's for the pre-release
  136.            nodes only.
  137.  
  138.                 Each  time  you run TICK 1.32+,  the program will first scan
  139.            the HOLD directory for TOK files.   If it finds any,  it examines
  140.            them  to  see  if  the associated pre-release file is "ripe" yet.
  141.            When it is,  the file is moved to the destination  (downloadable)
  142.            directory, the FILES.BBS is updated, and new attaches are created
  143.            to those nodes that do not have the "P" flag.
  144.  
  145.                 THIS IS ONLY PARTIALLY IMPLEMENTED YET ...  What I will need
  146.            to do is to provide for the case where the file is "ripe" but all
  147.            the "P" flagged nodes have not yet received the file.    In  that
  148.            instance, the existing file attaches will become invalid when the
  149.            file  is moved.   I need to write code that will look for any un-
  150.            delivered attaches for that file,  and alter the FLO  or  MSG  to
  151.            point to the proper place.   Right now that hasn't been coded, so
  152.            if all "P" nodes have not had their files  delivered  before  the
  153.            time comes, they won't get them at all.
  154.  
  155.                 Pre-release  can be set up in two ways.   Currently,  in the
  156.            SDS the public echos go not only to the SDS  nodes,  but  to  the
  157.            "end-user"  nodes  as  well.    If  files are to be directly pre-
  158.            released into the public echos such as SOFTDIST,  then  any  node
  159.            that  receives  pre-release files in that fashion must be running
  160.            1.32 or higher,  as lower numbered version will forward all files
  161.            without reservation, as will FLEA (with minor reservation).  This
  162.            could still be used in this fashion if all SDS RC's decide to run
  163.            the new TICK when it's ready.   The second way,  and probably the
  164.            more secure way,  would be to set up a separate pre-release  echo
  165.            associated with each public echo.   For example, PRESOFT could be
  166.            associated  with  SOFTDIST,  PREBINK  could  be  associated  with
  167.            SDSBINK,  etc.  When these would be set up, the public area would
  168.            be listed as a secondary area.   Then all  nodes  listed  in  the
  169.            PRExxx  echo could be "P" nodes,  and non-P nodes would be in the
  170.            secondary area.  This way, there would be less chance of acciden-
  171.  
  172.  
  173.  
  174.                                                                            3
  175.  
  176.  
  177.  
  178.                                    Betatic.doc
  179.  
  180.            tally linking to a non-prerelease node in the public echo.   This
  181.            setup  would  not effect the normal operation of the public echos
  182.            at all.
  183.  
  184.                 EXAMPLE:  AREA d:\prebink PREBINK SDSBINK
  185.                                1:261/662 password *HP
  186.                                1:135/204 passw2 HP
  187.  
  188.                           AREA d:\sdsbink SDSBINK
  189.                                1:261/662 passw3 *H
  190.                                1:266/13  passw4 C
  191.                                1:132/101 passww C
  192.  
  193.                 In this example, you can receive normal file from 261/662 in
  194.            either PREBINK or SDSBINK.  You can receive Pre-Release file from
  195.            261/662 in PREBINK.  If you receive a normal file in PREBINK, all
  196.            nodes listed in BOTH areas will  get  it  immediately.    If  you
  197.            receive  a  normal  file  in  SDSBINK,  then  only those nodes in
  198.            SDSBINK will receive the file,  and if you receive a  pre-release
  199.            file  in PREBINK,  then it will be echoed to 135/204 immediately,
  200.            and will be released to the rest of the nodes when it's ripe.
  201.  
  202.                 NOW you should all understand why I was going  to  all  that
  203.            bother to create the "secondary areas" stuff!
  204.  
  205.                 NOTE:  With the addition of pre-release, it's VERY important
  206.            that the TZ environmental variable be set properly.  If it isn't,
  207.            release times will be off.
  208.  
  209.                 KEEP IN MIND THAT THIS IS NOT YET FULLY FUNCTIONAL ... THERE
  210.            IS  NO  PROVISION  YET  FOR  THE  CASE  WHERE  A "P" NODE HAS NOT
  211.            RECEIVED THE FILE BY RELEASE DATE.
  212.  
  213.                 ~~~~~~~~~~~~~~~~~~~~
  214.  
  215.                 Tick 1.33 -
  216.  
  217.  
  218.                 * Hatch will now log the file  release  information  to  the
  219.            log.
  220.  
  221.                 *  If you are using HATCH with the "No Wait" (/ON) option in
  222.            a batch file,  HATCH will no longer loop back for a new  filename
  223.            if stopdup detects a duplicate entry.   It will now abort with an
  224.            error level 2.
  225.  
  226.                 * TICK now attempts to  determine  if  you  are  running  it
  227.            during  a Seadog mail event,  and will postpone release of a file
  228.            if there are undelivered pre-release attaches for that  file  al-
  229.            ready packetized.
  230.  
  231.  
  232.                                                                            4
  233.  
  234.  
  235.  
  236.                                    Betatic.doc
  237.  
  238.                 *  Added  certain  error recovery routines for the "release"
  239.            function ... previously an error would always abort the program.
  240.  
  241.                 ~~~~~~~~~~~~~~~~~~~~~
  242.  
  243.                 Tick 1.34 -
  244.  
  245.                 * Fixed (at least one) error caused by the compiler not fol-
  246.            lowing its documented rules of  precedence.    This  would  cause
  247.            memory trashing and eventual bombing of the program.
  248.  
  249.                 *  Added  additional checks for failed closes after a write,
  250.            (Usually meaning that the disk is out of space).
  251.  
  252.                 * TICK and HATCH now require a TZ to be set to run.  You may
  253.            either set it in the environment before calling  the  program(s),
  254.            or you can add it to the CFG file in the form:
  255.  
  256.                      TZ EST5EDT
  257.  
  258.                 If  BOTH  are set,  TICK/HATCH will use the one from the en-
  259.            vironment.   No test is done to see that the  value  you  set  is
  260.            valid.  You can lead a horse to water ....
  261.  
  262.                 *  Fixed  the  FROM  line  that HATCH was putting in the TOK
  263.            files.  Right now the FROM line is not used there, but it's there
  264.            in case it comes in handy later.
  265.  
  266.                 * Added new Stopdup support ... Stopdup is now smarter.   If
  267.            you  do nothing,  it will continue to act as before.   Any dupli-
  268.            cated filenames in an area will not echo or toss  if  STOPDUP  is
  269.            defined in the CFG.
  270.  
  271.                 If you add the keyword DupByCRC, and have the CRC2DUP option
  272.            active, then STOPDUP will cause TICK to test not only the NAME of
  273.            the file,  but also the CRC32 of the file.  A "hit" will only oc-
  274.            cur if the the CRC matches as well as the name.   This will allow
  275.            same-named  files to pass Stopdup if the files are different than
  276.            the one previously seen.  If the older / same-named file is still
  277.            in the "toss-to" directory, it will (presently) be overwritten.
  278.  
  279.                 *  If you choose to not set  the  global  DupByCRC  keyword,
  280.            which affects ALL areas, you can selectively still employ the new
  281.            dup-check  routine  in  selected areas of your choice by adding a
  282.            "LOCAL DupByCRC" to the list of LOCAL lines  following  the  AREA
  283.            definition line.
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.                                                                            5
  291.  
  292.  
  293.  
  294.                                    Betatic.doc
  295.  
  296.                 *    Should  you decide you want to use the CRC dup checking
  297.            routine in most areas,  but wish to exclude a few,  you may place
  298.            the  DupByCRC  keyword  in the CFG,  and add a "LOCAL NoDupByCRC"
  299.            line to the list of LOCAL lines  following  the  AREA  definition
  300.            line.
  301.  
  302.                 *    If you decide to use the newer CRC-based DUP detection,
  303.            any DUP file lines that contain only a filename and no CRC number
  304.            (such as may exist from previously running the  programs  without
  305.            CRC2DUP in the CFG) will be tested by the older stopdup logic.
  306.  
  307.  
  308.  
  309.                      Barry Geller
  310.                           609-482-8604
  311.                                1:266/12
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.                                                                            6
  349.